---
title: 使用 Bun 和 Astro
description: 学习如何在 Astro 网站上使用 Bun。
type: recipe
i18nReady: true
---

[Bun](https://bun.sh/) 是为提高速度而构建的 JavaScript 运行时。有关更多信息请参阅 [Bun 官方文档](https://bun.sh/docs)。

将 Bun 与 Astro 结合使用仍处于实验阶段。某些整合可能无法如预期般工作。如果你在[使用 Bun 时遇到任何问题](https://github.com/oven-sh/bun/issues/new/choose)，请在 [GitHub 上提交一个 issue](https://github.com/withastro/astro/issues/new/choose)！

## 安装 Bun

使用以下命令安装 Bun：

```bash
curl -fsSL https://bun.sh/install | bash
```

## 用 Bun 创建一个新的 Astro 项目

使用下面的 `Create Astro` 命令用 Bun 创建一个新的 Astro 项目:

```bash
bunx create-astro@latest my-astro-project-using-bun
```

:::tip[提示]
你也可以使用 `--template` 标志[从任何现有的 Astro GitHub 存储库中创建一个新的 Astro 项目](/zh-cn/install/auto/#入门模板):

```bash
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
```

:::

## 安装依赖项

如果你使用 `bunx create-astro` 启动一个新项目，CLI 会自动使用 Bun 来安装依赖项，你可以跳过这一步。

否则，你需要使用 Bun 安装依赖项：

```bash
bun run dev
```

:::note[注意]
使用完整的命令 `bun run dev` 启动 Astro 开发服务器。命令 `bun dev` 将启动 bun 自己的内部开发服务器。
:::

## 使用 Astro 集成

你也可以使用任何官方的 Astro 集成与 Bun 和 `Astro add` 命令：

```bash
bunx astro add react
```

这与使用 NPM 完全一样，但使用 Bun 的快速运行时带来了额外的好处。

:::note[注意]
某些集成可能无法如预期般工作。如果你发现任何问题，请在 [GitHub 上提交一个 issue](https://github.com/withastro/astro/issues/new/choose)！
:::

## 用 Bun 构建你的网站

为了构建和服务你的站点，Bun 有以下的命令：

```bash
bun run build
```

Bun 的 build 命令将把站点输出到 `dist/` 目录。

然后，你可以使用 `preview` 命令来预览你的网站：

```bash
bun preview
```
